home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-madman-mtamib-00.txt < prev    next >
Text File  |  1993-06-21  |  16KB  |  545 lines
  1.  
  2.                             Internet Draft
  3.                          Mail Monitoring MIB
  4.  
  5.                           MADMAN Working Group
  6.                              June 18, 1993
  7.                       Expires: December 18, 1993
  8.  
  9. Status of this Memo
  10.  
  11. This document is an Internet Draft. Internet Drafts are working
  12. documents of the Internet Engineering Task Force (IETF), its Areas,
  13. and its Working Groups. Note that other groups may also distribute
  14. working documents as Internet Drafts.
  15.  
  16. Internet Drafts are draft documents valid for a maximum of six 
  17. months.    Internet Drafts may be updated, replaced, or obsoleted by
  18. other documents at any time.  It is not appropriate to use Internet
  19. Drafts as reference material or to cite them other than as a "working
  20. draft" or "work in progress."
  21.  
  22. Please check the I-D abstract listing contained in each Internet 
  23. Draft directory to learn the current status of this or any  other
  24. Internet Draft.
  25.  
  26. Abstract
  27.  
  28. This document extends the basic Network Services Monitoring MIB to
  29. allow monitoring of Message Transfer Agents (MTAs).
  30.  
  31. MTA Objects
  32.  
  33. If there are one or more MTAs on the host, the following mta group may
  34. be used to monitor them. Any number of the MTAs on a host may be
  35. monitored. Each MTA is dealt with as a separate application and has
  36. its own applTable entry in the Network Services Monitoring MIB.
  37.  
  38. Message Flow Model
  39.  
  40. A general model of message flow inside an MTA has to be presented
  41. before a MIB can be described. Generally speaking, message flow occurs
  42. in four steps:
  43.  
  44. (1) Messages are submitted to the MTA by User Agents, Message
  45.     Stores, other MTAs, and gateways.
  46.  
  47. (2) The "next hop" for the each message is determined. This is simply the
  48.     destination the message is to be delivered to; it may or may not be the
  49.     final destination of the message. Multiple "next hops" may exist for a
  50.     single message (as a result of either having multiple recipients or
  51.     distribution list expansion); this may make it necessary to duplicate
  52.     messages.
  53.  
  54. (3) Messages are converted into the format that's appropriate for the next
  55.     hop.
  56.  
  57. (4) Messages are delivered to the appropriate destination, which may be a
  58.     User Agent, Message Store, another MTA, or another gateway.
  59.  
  60. Storage of messages in the MTA occurs at some point during this
  61. process. However, it is important to note that storage may occur at
  62. different and possibly even multiple points during this process. For
  63. example, some MTAs expand messages into multiple copies as they are
  64. received. In this case (1), (2), and (3) all occur prior to storage.
  65. Other MTAs store messages precisely as they are received and perform
  66. all expansion and conversion processing during retransmission
  67. processing. So here only (1) occurs prior to storage. This leads to a
  68. situation where, in general, a measurement of messages received may
  69. not equal a measurement of messages in store, a measurement of
  70. messages stored may not equal a measurement of messages retransmitted,
  71. or both.
  72.  
  73. MTA-MIB DEFINITIONS ::= BEGIN
  74.  
  75. IMPORTS
  76.     OBJECT-TYPE FROM RFC-1212
  77.     experimental, Counter, Gauge FROM RFC1155-SMI
  78.     DisplayString FROM RFC1213-MIB
  79.     applIndex, applProtoID FROM APPLICATION-MIB;
  80.  
  81. mta OBJECT IDENTIFIER ::= {experimental xxx}
  82.  
  83. mtaTable OBJECT-TYPE
  84.     SYNTAX SEQUENCE OF MTAEntry
  85.     ACCESS not-accessible
  86.     STATUS mandatory
  87.     DESCRIPTION
  88.       "The table holding information specific to an MTA."
  89.     ::= {mta 1}
  90.  
  91. mtaEntry OBJECT-TYPE
  92.     SYNTAX MTAEntry
  93.     ACCESS not-accessible
  94.     STATUS mandatory
  95.     DESCRIPTION
  96.       "The entry associated with each MTA."
  97.     INDEX {applIndex}
  98.     ::= {mtaTable 1}
  99.  
  100. MTAEntry ::= SEQUENCE {
  101.     mtaSubmittedMessages
  102.       Counter,
  103.     mtaStoredMessages
  104.       Gauge,
  105.     mtaDeliveredMessages
  106.       Counter,
  107.     mtaSubmittedVolume
  108.       Counter,
  109.     mtaStoredVolume
  110.       Gauge,
  111.     mtaDeliveredVolume
  112.       Counter,
  113.     mtaSubmittedRecipients
  114.       Counter,
  115.     mtaStoredRecipients
  116.       Gauge,
  117.     mtaDeliveredRecipients
  118.       Counter
  119. }
  120.   
  121. mtaSubmittedMessages OBJECT-TYPE
  122.     SYNTAX Counter
  123.     ACCESS read-only
  124.     STATUS mandatory
  125.     DESCRIPTION
  126.       "The number of messages submitted since MTA initialization."
  127.     ::= {mtaEntry 1}
  128.  
  129. mtaStoredMessages OBJECT-TYPE
  130.     SYNTAX Gauge
  131.     ACCESS read-only
  132.     STATUS mandatory
  133.     DESCRIPTION
  134.        "The total number of messages currently stored in the MTA."
  135.     ::= {mtaEntry 2}
  136.  
  137. mtaDeliveredMessages OBJECT-TYPE
  138.     SYNTAX Counter
  139.     ACCESS read-only
  140.     STATUS mandatory
  141.     DESCRIPTION
  142.       "The number of messages delivered since MTA initialization."
  143.     ::= {mtaEntry 3}
  144.  
  145. mtaSubmittedVolume OBJECT-TYPE
  146.     SYNTAX Counter
  147.     ACCESS read-only
  148.     STATUS mandatory
  149.     DESCRIPTION
  150.        "The total volume of messages submitted since MTA
  151.        initialization, measured in kbytes."
  152.     ::= {mtaEntry 4}
  153.  
  154. mtaStoredVolume OBJECT-TYPE
  155.     SYNTAX Gauge
  156.     ACCESS read-only
  157.     STATUS mandatory
  158.     DESCRIPTION
  159.        "The total volume of messages currently stored in the MTA,
  160.        measured in kbytes."
  161.     ::= {mtaEntry 5}
  162.  
  163. mtaDeliveredVolume OBJECT-TYPE
  164.     SYNTAX Counter
  165.     ACCESS read-only
  166.     STATUS mandatory
  167.     DESCRIPTION
  168.       "The total volume of messages delivered since MTA
  169.       initialization, measured in kbytes."
  170.     ::= {mtaEntry 6}
  171.  
  172. mtaSubmittedRecipients OBJECT-TYPE
  173.     SYNTAX Counter
  174.     ACCESS read-only
  175.     STATUS mandatory
  176.     DESCRIPTION
  177.        "The total number of recipients specified in all messages submitted
  178.        since MTA initialization."
  179.     ::= {mtaEntry 7}
  180.  
  181. mtaStoredRecipients OBJECT-TYPE
  182.     SYNTAX Gauge
  183.     ACCESS read-only
  184.     STATUS mandatory
  185.     DESCRIPTION
  186.        "The total number of recipients specified in all messages currently
  187.        stored in the MTA."
  188.     ::= {mtaEntry 8}
  189.  
  190. mtaDeliveredRecipients OBJECT-TYPE
  191.     SYNTAX Counter
  192.     ACCESS read-only
  193.     STATUS mandatory
  194.     DESCRIPTION
  195.       "The total number of recipients specified in all messages delivered
  196.       since MTA initialization."
  197.     ::= {mtaEntry 9}
  198.  
  199. -- MTAs typically group inbound submissions, queue storage, and
  200. -- outbound deliveries in some way. In the most extreme case
  201. -- information will be maintained for each different entity that
  202. -- submits messages and for each entity the MTA stores messages for
  203. -- and delivers messages to.  Other MTAs may elect to treat all
  204. -- submissions equally, all queue storage equally, all deliveries
  205. -- equally, or some combination of this.
  206.  
  207. -- In any case, a grouping abstraction is an extremely useful for
  208. -- breaking down the activities of an MTA. For purposes of labelling
  209. -- this will be called a "group" in this MIB.
  210.  
  211. -- The term "channel" is often used in MTA implementations; channels
  212. -- are usually, but not always, equivalent to a "group". However,
  213. -- this MIB does not use the term "channel" because there is no
  214. -- requirement that an MTA supporting this MIB has to map its
  215. -- "channel" abstration one-to-one onto the MIB's group abstration.
  216.  
  217. groupTable OBJECT-TYPE
  218.     SYNTAX SEQUENCE OF GroupEntry
  219.     ACCESS not-accessible
  220.     STATUS mandatory
  221.     DESCRIPTION
  222.         "The table holding information specific to each MTA group."
  223.     ::= {mta 2}
  224.  
  225. groupEntry OBJECT-TYPE
  226.     SYNTAX GroupEntry
  227.     ACCESS not-accessible
  228.     STATUS mandatory
  229.     DESCRIPTION
  230.       "The entry associated with each MTA group."
  231.     INDEX {applIndex, groupIndex}
  232.     ::= {groupTable 1}
  233.  
  234. GroupEntry ::= SEQUENCE {
  235.     groupIndex
  236.         INTEGER,
  237.     groupSubmittedMessages
  238.         Counter,
  239.     groupRejectedMessages
  240.         Counter,
  241.     groupStoredMessages
  242.         Gauge,
  243.     groupDeliveredMessages
  244.         Counter,
  245.     groupSubmittedVolume
  246.         Counter,
  247.     groupStoredVolume
  248.         Gauge,
  249.     groupDeliveredVolume
  250.         Counter,
  251.     groupSubmittedRecipients
  252.         Counter,
  253.     groupStoredRecipients
  254.         Gauge,
  255.     groupDeliveredRecipients
  256.         Counter,
  257.     groupQueuedMtaAssociationIndex
  258.         INTEGER,
  259.     groupOldestMessageStored
  260.         TimeTicks,
  261.     groupInboundAssociations
  262.         Gauge,
  263.     groupOutboundAssociations
  264.         Gauge,
  265.     groupAccumulatedInboundAssociations
  266.         Counter,
  267.     groupAccumulatedOutboundAssociations
  268.         Counter,
  269.     groupLastInboundActivity
  270.         TimeTicks,
  271.     groupLastOutboundActivity
  272.         TimeTicks,
  273.     groupRejectedInboundAssociations
  274.         Counter,
  275.     groupFailedOutboundAssociations
  276.         Counter,
  277.     groupInboundRejectionReason
  278.         DisplayString,
  279.     groupOutboundConnectFailureReason
  280.         DisplayString,
  281.     groupScheduledRetry
  282.         TimeTicks,
  283.     groupMailProtocol
  284.         OBJECT IDENTIFIER,
  285.     groupName
  286.         DisplayString
  287. }
  288.  
  289. groupIndex OBJECT-TYPE
  290.     SYNTAX INTEGER (1..2147483647)
  291.     ACCESS read-only
  292.     STATUS mandatory
  293.     DESCRIPTION
  294.     "The index associated with a group for a given MTA."
  295.     ::= {groupEntry 1}
  296.  
  297. groupSubmittedMessages OBJECT-TYPE
  298.     SYNTAX Counter
  299.     ACCESS read-only
  300.     STATUS mandatory
  301.     DESCRIPTION
  302.       "The number of messages submitted to this group since MTA
  303.       initialization."
  304.     ::= {groupEntry 2}
  305.  
  306. groupSubmittedMessages OBJECT-TYPE
  307.     SYNTAX Counter
  308.     ACCESS read-only
  309.     STATUS mandatory
  310.     DESCRIPTION
  311.       "The number of messages rejected by this group since MTA
  312.       initialization."
  313.     ::= {groupEntry 3}
  314.  
  315. groupStoredMessages OBJECT-TYPE
  316.     SYNTAX Gauge
  317.     ACCESS read-only
  318.     STATUS mandatory
  319.     DESCRIPTION
  320.        "The total number of messages currently stored in this
  321.        group's queue."
  322.     ::= {groupEntry 4}
  323.  
  324. groupDeliveredMessages OBJECT-TYPE
  325.     SYNTAX Counter
  326.     ACCESS read-only
  327.     STATUS mandatory
  328.     DESCRIPTION
  329.       "The number of messages delivered by this group since MTA
  330.       initialization."
  331.     ::= {groupEntry 5}
  332.  
  333. groupSubmittedVolume OBJECT-TYPE
  334.     SYNTAX Counter
  335.     ACCESS read-only
  336.     STATUS mandatory
  337.     DESCRIPTION
  338.        "The total volume of messages submitted to this group since
  339.        MTA initialization, measured in kbytes."
  340.     ::= {groupEntry 6}
  341.  
  342. groupStoredVolume OBJECT-TYPE
  343.     SYNTAX Gauge
  344.     ACCESS read-only
  345.     STATUS mandatory
  346.     DESCRIPTION
  347.        "The total volume of messages currently stored in this
  348.        group's queue, measured in kbytes."
  349.     ::= {groupEntry 7}
  350.  
  351. groupDeliveredVolume OBJECT-TYPE
  352.     SYNTAX Counter
  353.     ACCESS read-only
  354.     STATUS mandatory
  355.     DESCRIPTION
  356.       "The total volume of messages delivered by this group since
  357.       MTA initialization, measured in kbytes."
  358.     ::= {groupEntry 8}
  359.  
  360. groupSubmittedRecipients OBJECT-TYPE
  361.     SYNTAX Counter
  362.     ACCESS read-only
  363.     STATUS mandatory
  364.     DESCRIPTION
  365.        "The total number of recipients specified in all messages
  366.        submitted to this group since MTA initialization."
  367.     ::= {groupEntry 9}
  368.  
  369. groupStoredRecipients OBJECT-TYPE
  370.     SYNTAX Gauge
  371.     ACCESS read-only
  372.     STATUS mandatory
  373.     DESCRIPTION
  374.        "The total number of recipients specified in all messages
  375.        currently stored in this group's queue."
  376.     ::= {groupEntry 10}
  377.  
  378. groupDeliveredRecipients OBJECT-TYPE
  379.     SYNTAX Counter
  380.     ACCESS read-only
  381.     STATUS mandatory
  382.     DESCRIPTION
  383.       "The total number of recipients specified in all messages
  384.       delivered by this group since MTA initialization."
  385.     ::= {groupEntry 11}
  386.  
  387. groupQueuedMtaAssociationIndex
  388.     SYNTAX INTEGER (0..2147483647)
  389.     ACCESS read-only
  390.     STATUS mandatory
  391.     DESCRIPTION
  392.       "Reference into association table to allow correlation of this
  393.       group's active association with the association table.  If
  394.       there is no active association for this group this value should
  395.       be 0."
  396.     ::= {groupEntry 12}
  397.  
  398. groupOldestMessageStored
  399.     SYNTAX TimeTicks
  400.     ACCESS read-only
  401.     STATUS mandatory
  402.     DESCRIPTION
  403.       "The age of the oldest message in this group's queue."
  404.     ::= {groupEntry 13}
  405.  
  406. groupInboundAssociations OBJECT-TYPE
  407.     SYNTAX Gauge
  408.     ACCESS read-only
  409.     STATUS mandatory
  410.     DESCRIPTION
  411.       "The number of current associations to the group, where the
  412.        group is the responder."  For dynamic single
  413.     ::= {groupEntry 14}
  414.  
  415. groupOutboundAssociations OBJECT-TYPE
  416.     SYNTAX Gauge
  417.     ACCESS read-only
  418.     STATUS mandatory
  419.     DESCRIPTION
  420.       "The number of current associations to the group, where the
  421.       group is the initiator."
  422.     ::= {groupEntry 15}
  423.  
  424. groupAccumulatedInboundAssociations OBJECT-TYPE
  425.     SYNTAX Counter
  426.     ACCESS read-only
  427.     STATUS mandatory
  428.     DESCRIPTION
  429.       "The total number of associations to the group since MTA
  430.       initialization, where the group is the responder."
  431.     ::= {groupEntry 16}
  432.  
  433. groupAccumulatedOutboundAssociations OBJECT-TYPE
  434.     SYNTAX Counter
  435.     ACCESS read-only
  436.     STATUS mandatory
  437.     DESCRIPTION
  438.       "The total number of associations from the group since MTA
  439.        initialization, where the group was the initiator."
  440.     ::= {groupEntry 17}
  441.  
  442. groupLastInboundActivity OBJECT-TYPE
  443.     SYNTAX TimeTicks
  444.     ACCESS read-only
  445.     STATUS mandatory
  446.     DESCRIPTION
  447.       "Time since the last time that this group had an active
  448.       inbound association for purposes of message submission."
  449.     ::= {groupEntry 18}
  450.      
  451. groupLastOutboundActivity OBJECT-TYPE
  452.     SYNTAX TimeTicks
  453.     ACCESS read-only
  454.     STATUS mandatory
  455.     DESCRIPTION
  456.       "Time since the last time that this group had an
  457.       outbound association for purposes of message delivery."
  458.     ::= {groupEntry 19}
  459.  
  460. groupRejectedInboundAssociations OBJECT-TYPE
  461.     SYNTAX Counter
  462.     ACCESS read-only
  463.     STATUS mandatory
  464.     DESCRIPTION
  465.       "The total number of inbound associations the group has
  466.       rejected, since MTA initialization."
  467.     ::= {groupEntry 20}
  468.  
  469. groupFailedOutboundAssociations OBJECT-TYPE
  470.     SYNTAX Counter
  471.     ACCESS read-only
  472.     STATUS mandatory
  473.     DESCRIPTION
  474.       "The total number associations where the group was the
  475.       initiator and association establishment has failed,
  476.       since MTA initialization."
  477.     ::= {groupEntry 21}
  478.  
  479. groupInboundRejectionReason
  480.     SYNTAX DisplayString
  481.     ACCESS read-only
  482.     STATUS mandatory
  483.     DESCRIPTION
  484.       "The failure reason, if any, for the last connection this
  485.       group refused to respond to. An empty string indicates that
  486.       the last attempt was successful.  If no connection attempt has
  487.       been made since the MTA was initializaed the value should be
  488.       'never'."
  489.     ::= {groupEntry 22}
  490.  
  491. groupOutboundConnectFailureReason
  492.     SYNTAX DisplayString
  493.     ACCESS read-only
  494.     STATUS mandatory
  495.     DESCRIPTION
  496.       "The failure reason, if any, for the last connection attempt
  497.       this group initiated. An empty string indicates that the last
  498.       attempt was successful.  If no connection attempt has been
  499.       made since the MTA was initializaed the value should be
  500.       'never'."
  501.     ::= {groupEntry 23}
  502.  
  503. groupScheduledRetry OBJECT-TYPE
  504.     SYNTAX TimeTicks
  505.     ACCESS read-only
  506.     STATUS mandatory
  507.     DESCRIPTION
  508.       "The scheduled time at which this group will next attempt to
  509.       make a connection.  This time is relative to the query time."
  510.     ::= {groupEntry 24}
  511.  
  512. groupMailProtocol OBJECT-TYPE
  513.     SYNTAX OBJECT IDENTIFIER
  514.     ACCESS read-only
  515.     STATUS mandatory
  516.     DESCRIPTION
  517.       "An identification of the protocol being used by this group.
  518.       For an group employing OSI protocols, this will be the
  519.       Application Context.  For Internet applications, the IANA
  520.       maintains a registry of the OIDs which correspond to well-known
  521.       message transfer protocols.  If the application protocol is not
  522.       listed in the registry, the value {applProtoID port} is used
  523.       where 'port' corresponds to the primary port being used by the
  524.       group."
  525.     ::= {groupEntry 25}
  526.  
  527. groupName OBJECT-TYPE
  528.     SYNTAX DisplayString
  529.     ACCESS read-only
  530.     STATUS mandatory
  531.     DESCRIPTION
  532.       "A descriptive name for the name. If this group connects to
  533.       a single remote MTA this should be the name of that MTA. If
  534.       this in turn is an Internet MTA this should be the domain name.
  535.       For an OSI MTA it should be the string encoded distinguished
  536.       name of the managed object using the format defined in RFC-?.
  537.       For X.400(1984) MTAs which do not have a Distinguished Name,
  538.       the RFC-1327 syntax 'mta in globalid' should be used."
  539.     ::= {groupEntry 26}
  540.  
  541. END
  542.  
  543. Expires: December 18, 1993
  544.  
  545.